Skip to content

docs: mark cross-host presence experimental - #107

Open
myobie wants to merge 1 commit into
mainfrom
agent/experimental-cross-host-presence
Open

docs: mark cross-host presence experimental#107
myobie wants to merge 1 commit into
mainfrom
agent/experimental-cross-host-presence

Conversation

@myobie

@myobie myobie commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Why

Cross-host presence is not reliable enough to serve as health or lifecycle authority. Under ordinary content replication, a same-value status refresh may update host-local freshness metadata without changing file bytes; a remote observer can then age the unchanged value to unknown. The current replication mechanism gap is tracked in compoundingtech/fabric#27.

What

  • mark cross-host presence as EXPERIMENTAL and best-effort in st2 agents --help
  • state that ordinary replication may be delayed, stale, or asymmetric
  • define a remote unknown as no fresh observation, not proof that an agent or host is unhealthy
  • state that cross-host presence never gates local work or triggers restart, teardown, reconciliation, or a global-fleet health conclusion
  • keep host-local runtime and service evidence authoritative for lifecycle decisions
  • add a focused CLI-help regression test covering every boundary above

Impact

This changes help text only. It does not change presence calculation, status refresh, doctor behavior, reconciliation, restart, teardown, service behavior, catalog data, or runtime state. It introduces no peer type or health classification.

Checks

  • cargo run --quiet -- agents --help — rendered wording inspected
  • cargo test --test status_agents -- --nocapture — 4 passed
  • cargo test --lib status::tests -- --nocapture — 9 passed
  • cargo clippy --test status_agents -- -D warnings -A clippy::too_many_arguments — passed; the allowance is for an unrelated current-main lint in eval_run::wait_done
  • git diff --check — passed
  • cargo fmt --check — current-main baseline remains broadly red across unrelated files; this patch does not reformat them

Base: c6846f6239329f0803142afc06c15a07b93937c1.

@myobie
myobie marked this pull request as ready for review July 30, 2026 21:54
@schickling schickling added area:presence Presence, status records, and heartbeats · Set: manual type:docs Documentation-only change or documentation task · Set: manual labels Aug 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:presence Presence, status records, and heartbeats · Set: manual type:docs Documentation-only change or documentation task · Set: manual

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants